SLAMPP SLAMPPLiveCD : HowTo HomePage :: Categories :: PageIndex :: RecentChanges :: RecentlyCommented :: Login/Register SLAMPP Documentation How To Copy to Ram If you want SLAMPP to load and run faster and have at least 300 MB of RAM you can use the copy2ram command. As SLAMPP boots, when it says boot: type: 'slampp copy2ram'. It will take a minute or two to copy the whole disc to run but once this is done, SLAMPP will run much faster. Also, if you only have one disc drive on your computer and wish to insert another CD/DVD in SLAMPP you can use 'slampp copy2ram' which will copy the disc to RAM and then automatically eject the disc to free up your drive. This is a very handy tool. Boot SLAMPP from your hard drive (installing SLAMPP) If you want to install SLAMPP on your hard drive, make sure you have a free Linux partition. It could be ext2 or ext3. Then go to your Xfce desktop and double click on the "HD Installation" program icon. Make sure you select the right hard drive partition, you probably don't want to install SLAMPP over another operating system you have. It installs LILO with it, which means that the installation could make Windows, (or other operating systems installed on the drive) unbootable. So you should only do this if you know how to use and edit LILO. As I don't have SATA or RAID on my PC to test with, I can't confirm that this program would work on those systems. For IDE/ATA, before starting the HD installation program please make sure that the partition you would like SLAMPP to be installed to is unmounted. Otherwise, the program will refuse to work. For people who would like to do the installation on console, just run the following commands: # cd /hd_install # python slampp_install_run.py --device=/dev/hda1 Don't foget to change '/dev/hda1' with the right partition. Use and create a swap partition If your hard drive already contains a Linux swap partition, SLAMPP will automatically detect it and use it. However, if you don't want to mess around with your drive and create a swap partition, you can create a swap file. However, if you have another partition, here's how to make a swap file. Type 'fileswap /mnt/hda1/swap.swp 200' for example to make a swap file on the first partition of your first hard drive. The '200' tells it to make a 200MB swap partition. The swap file will not be deleted on a reboot. The fileswap command must be used for each time you boot Slax though. The swap file won't be auto detected. Note: DO NOT use the fileswap command more than once per boot. Doing so can create major problems. Use Webmin to manage servers and daemons If you are not that familiar using command line to manage all servers and daemons on SLAMPP, you can administer them through a web browser. Just open the web browser and then type 'https://localhost:10000/'8. Then enter 'root' as username and 'slampp' for password. Web development and design SLAMPP is equipped with tools and applications that support the web development and design processes. At this moment it supports PHP 4, Perl and Python and uses MySQL as database backend. Not to be forgotten, it also includes web server Apache with various mods and plugins that makes your work a little bit easier. Text and WYSIWYG editors like Bluefish, Nvu, and TEA are available to help you writing the scripts or to code. Special treatment for web designers, SLAMPP has some tools that can not be missed like The GIMP, Blender and Inkscape. Shortcuts to all of these applications can easily be found on your dekstop menu. Getting your files on the CD Do you have websites or other web applications you would like to show to others? Or do you just want to have a good working backup of them on the CD? Then you come to the right solution. SLAMPP helps web masters, developers and designers in promoting their work and makes their clients impressed with that. Just read the following instructions found on LAMPPIX website to start with this feature. (Note: don't forget to replace folder 'www' with 'html'.) http://lamppix.tinowagner.com/wiki/index.php?GettingYourFilesOnTheCD8 After that, on console type the following command: sh /etc/webinstall.sh All files and database on the CD will be recognized and inserted automatically. Then open the web browser and if anything goes well, your website or web application will be displayed right away. This feature is using the LAMPP scripts provided by LAMPPIX8, Make your own SSL certificates Do you have a static IP address? Do you want to have own SSL certicates for your website? Then, this solution will help you out. Just type the following command on console. /etc/apache/pkgmkcert.sh Firewall SLAMPP is equipped with three firewall programs which can be used anytime you want. Of course you only need to use one at the time. FireHOL To activate FireHOL, just type this command on console: /etc/rc.d/rc.firehol start To stop: /etc/rc.d/firehol stop The configuration file, firehol.conf, can be found in /etc/firehol folder. You need to modify this before using FireHOL. If you want to have a quick configuration file for you recent system, you can let FireHOL make automatically one for you. Just type this command on console: /etc/firehol/firehol.sh helpme >/tmp/firehol.conf A temporrary firehol.conf is created. Edit it necessarily and when it is OK, put it in /etc/firehol folder. Restart Firehol, /etc/rc.d.rc.firehol restart. Finished. FireHOL homepage: http://firehol.sourceforge.net8 Linux Firewall Like FireHOL, it can automatically recognize your system and make a rc.firewall file for you. Run this command on console: firewall_install A window will be displayed and guide you to manage your firewall system. When you are done, just copy the rc.firewall file to /etc/rc.d folder. Edit the rc.local and add rc.firewall to have firewall activetd during startup process. Don't forget to make the rc.firewall file executable first, chmod +x rc.firewall Done! Linux Firewall homepage: http://projectfiles.com/firewall/8 Firestarter This programs has graphical interface to setup firewall rules and can also be used to share internet connections for home network. Very easy to use and handy if you don't know anything about configuring firewall in Linux. More information can be found on its homepage, http://www.fs-security.com/8 Multimedia Although SLAMPP is meant for simplying your work to setup a home server, it doesn't mean that it will ignore your multimedia pleasure. Some small multimedia programs have been included on SLAMPP. Unfortunately those programs have no graphical interfaces, thus they must be run on console. Burn a CD Go to start menu, select 'BashBurn' on Utilities menu. Play music Open a console and then type 'mpg123' or 'amp' to play music. Of course, don't forget to add the file you want to listen to. Or, just use a graphical interface program, Beep Media Player, which can be found on 'Multimedia' menu. Play Video Run 'VLC Media Player' which can play various types of video file. It is located on 'Multimedia' menu. Use a module One of the greatest features of Slax that powers up SLAMPP is the fact that it is modular. That means if it doesn't have something you want, you can easily add it. These additions are called modules. A module is a something you can create or download which has a .mo extension. For example, you can add OpenOffice.org or a variety of games which weren't included in SLAMPP for size reasons. There are two ways to use a module: Edit Iso A great guy named Martijn Starrenburg created MySLAX Creator. Download it at http://myslax.bonsonno.org8 It allows you to modify your Slax/SLAMPP CD in Windows with a wizard-based approach so you can insert and remove modules from the .iso. It is very simple and guides you through all the steps. Uselivemod To use a module without burning a new CD, use this command. Uselivemod command expects one argument: a full path to the image file you wish to insert to live file system. It doesn't mater where the module is, you can download it while running SLAX/SLAMPP to /root (root's home directory), /mnt/disc0part1 (primary partition of your first hard drive), etc. Now, to load the module, open a console, (click the black icon on Xfce panel) and type uselivemod /root/modname.mo or uselivemod /mnt/hda1/modulename.mo. If all goes well, the computer will pause for a second and display no error. To use the program, check the start menu. If it's not in here, go to the console and use a command to start it (for example, Firefox module is started by executing /usr/share/Firefox/Firefox command). If you don't know the command you should use, explore the content of /mnt/livecd/imgro/modulename.mo. It's a directory which shows only files from your module. Make modules Making modules is really quite easy. However, it can take up some of your valuable time. Sometimes, if you're lucky, there will already be a Slackware package for the program you want. (Slackware packages end in .tgz) If you find the one you want, download it, and use the command tgz2mo /directory/file.tgz /directory/file.mo You now have an module that can be used with the uselivemod command, or by inserting the module into the .iso. To use the tgz2mo command takes even a slow typer under 2 minutes. Sometimes, however, you won't be so lucky. There are not Slackware packages for every program out there. For this, you must compile the program first and install it. This can't be done from within the ordinary Slax/SLAMPP. You need a standard distro installed to the hard drive (like Slackware, Mandrake, or Red Hat). Then, make a folder with the name of the module. In here, you will place an exact replication of the files and folders created by the program. For example, in Slax/SLAMPP, check /var/log/packages, and select a file from the list. Open it with TEA or whatever. All the files and directories listed there would need to be copied to the new folder. It may take a really long time, but it's still pretty easy. Now, once you have everything in there, type dir2mo /root/directory/ /root/file.mo You now have a module. This could take a couple hours. (Or a few minutes if your dealing with a small program with few files.) If you wish to convert an old Slax module with a *.img extension, use the img2mo command. If you make a good working module, which you think others might benefit from (they probably will) please upload it to the modules section on the Slax/SLAMPP website. Emulation Use Qemu Qemu is included in SLAMPP. It allows you to run other operating systems while running SLAMPP. To use it, open a console and type "qemu -m 128 -cdrom /mnt/disc0part1/slampp.iso -boot d -user-net" to start the ISO file. Of course, you need to have the ISO downloaded and called slampp.iso and on the first partition of your primary drive for this particular command to work. Save and restore configuration/settings To save your settings, run "configsave" command with one argument - the storage location. So type for example configsave /mnt/sda1/slamppconf.mo to save your configs in USB flash drive. It will save all changed files from /root, /etc, /home and /var directories. Then use "configrestore" command to restore your backup. You can also save settings to the root directory of your existing disk partition (for example to /mnt/hda1/slamppconf.mo). All settings found in the root folder of any of your disk partitions ( under the name slaxconf.mo) will be restored automatically when SLAMPP boots. Notes: This documentation is mainly compiled based on SLAX documentation written by Dustin Wielenga8. Some information are based on other sources. Please refer to the links provided in each information. SLAMPPLiveCD : FaQ HomePage :: Categories :: PageIndex :: RecentChanges :: RecentlyCommented :: Login/Register SLAMPP Documentation FAQ What is SLAMPP? As mentioned on the frontpage of this website, SLAMPP is a generic linux distribution based on current SLAX8 and Slackware linux8. The linux live scripts8 technology has made it possible to run SLAMPP directIy off CD/DVD-ROM drive. No hard disk is required although with help of a small program provided on SLAMPP you are able to install SLAMPP permanently on your PC. The main goal of SLAMPP is to provide easy setup of a home server or even for small office one. You just have to insert the CD and get all servers running with minimal effort. Why SLAMPP? You might ask why you should use SLAMPP. The answer is simply because it is designed to be easy even for beginners. You even don't have to install all applications or tools by yourself. A user can add additional tools or applications of his/her choice in form of modules without messing up the whole system. You may see it as a plug 'n play device. Use it whenever you need it without any risk. If something bad occurs, just restart your PC and all problems whould be gone as all data are stored in RAM. However, please use SLAMPP at your own responsibility and risk. SLAMPP comes with absolutely NO WARRANTY at all. How did you come to this idea? As I have been involved in various web projects in the last 5 years and have been using many web applications, the need for a ready to use solution is getting bigger and bigger. I need something that makes the life of web developers, web masters and web designers a little bit easier. Furthermore, not everyone can do the installation and maintenance of applications by themselves. Therefore such instant solution must be available to them. That's the main reason why SLAMPP is compiled. FYI, I'm not a linux expert. I do this because I'd like to learn linux by simply putting it in action. As an old wise man always says to us, "learning by doing" and "practice makes perfect" are the best things to do. So SLAMPP is designed as my tiny project to make the ideas come true and also as a playground to get my hands dirty a little bit. If you would like to help me enhance SLAMPP, please don't hesitate to contact me. I'm always welcome for any inputs. Any SLAX and/or Slackware's documentation available? Of course. You can get and read them all on their own homepage. - SLAX documentation8 - Slackware's documentation8 You can always refer to these documentations when using SLAMPP as it is based on SLAX and Slackware. I have no idea how to manage all servers and daemons on SLAMPP. I'm not a command liner. Don't worry. That's the reason why Webmin8 is included. Just open your browser and type this URL. https://localhost:10000/8 And then, login with this username/password combination: root / slampp This combination is your key to all password protected areas and authorized services. Does SLAMPP have a guest account? Yes. Just use username/password 'slampp / slampp' instead. You can add so many users you like if you want to. Does SLAMPP support virtual hosting? Yes. Virtualmin will help you manage virtual hostings. Just go to Webmin and under Servers tab you will find Virtualmin interface where you can easily add an account. I want to install the servers permanently and run my own web hosting. Can you point me a place where I can get more information on setting up and managing web hosting? This website, http://hostinghacks.net8, covers in details how you set up a web hosting service from scratch and manage to run it. Interestingly it has some how to's for some major linux distibutions. Beside SLAMPP, do you know which distros or softwares I can use to set up a home server? Beside major distributions like Fedora, Debian, CentOS, etc. you also can try the following solutions: - LAMPPIX: http://lamppix.tinowagner.com8 - LiveLAMP: http://www.livelamp.org8 - Vector Linux SOHO: http://vectorlinux.com8 - XAMPP: http://apachefriends.org/en/8 Where can I get more information how to set up a home server if I have DSL or Cable internet connection? Visit this website, http://www.dslwebserver.com/8 If I want to stop a specific server from starting up automatically during boot process where should I go? All processes during booting are configured in /etc/rc.d/ directory. If you want to turn off one server of your choice, just chmod -x the approriate rc.* file. It will make it unexecutable. For example, you want to stop MySQL, just type the following command: chmod -x rc.mysqld As result, MySQL will be not executed during the next boot up. I don't see proper documentation available at this moment for SLAMPP, why is that so? First of all, I would like to express my sincere apology for the lack of this feature. That was not my intention before to leave users without any guides. But as I'm not a good documentation writer, it is likely at this moment you have to refer other linux resources beside information you get here. As SLAMPP is based on SLAX and Slackware, you can take their documentation first as main reference. Or, you may also visit Wolvix documentation8 to get a better insight of inner working of SLAX. Just adjust everything you read over there with you have on SLAMPP. Or, visit other resources like The Linux Documentation Project, http://www.tldp.org/8 or other major linux forums available out there. I'm sure there are some nice people that could help you out with your questions. Please note, SLAMPP is not an unique distro, what you get in SLAMPP is also available in other distros. Moreover, as SLAMPP uses common packages, the effort to find information about something becomes much easier. With a little help of our friend, Google8, nothing is impossible now. :)